Document structure

General A standard written using the iso style must obey certain rules, as follows:
  1. The first non-comment line must be
        \documentstyle{iso}
    

  2. This must be followed by two lines giving the number and title of the standard, as follows:
        \standard{1234}
        \title{A standard for egg-sucking}
    

  3. Any user-defined LaTeX macros should follow the standard number and title. There should then follow the begin document command:
        \begin{document}
    

  4. Then come the foreword (optional, see [*]), tables of contents (optional, see [*]) and title commands. The title command is written thus:
        \maketitle
    

  5. The structure of the rest of the document is described in [*]. The document must finish with
        \end{document}
    

See annex [*] for an example standard.

Divisions and subdivisions

Names of divisions and subdivisions The iso style permits a document to be made up of the following divisions: part, section, clause, subclause, subsubclause, subsubsubclause.

Each type of division is introduced in the normal LaTeX manner by a command, whose name is that of the division type, and a parameter which is the title of the division. For example:

\section{A typical section}
\clause{This is a clause}
\subclause{Winds light to variable}
\subsubclause{The famous Eccles}
\subsubsubclause{The Greenslade story}

Each division generates a corresponding entry in the table of contents (see [*]).

There are also untitled versions of subsubclause and subsubsubclause introduced by \namelesssubsubclause and \namelesssubsubsubclause respectively. These have run-in headers and do not produce entries in the table of contents.

Finally there is the lowest level of division: the paragraph. This is unnumbered and untitled and introduced by either \par or a blank line.

Special divisions Tables of contents Tables of contents are produced in the usual LaTeX manner, using \tableofcontents, \listoffigures and \listoftables. These should come before the \maketitle, see [*].

Foreword The foreword to a standard appears before the table of contents and is unnumbered. For this reason, it uses a special macro as follows:

\foreword

This ensures that it is unnumbered and that no entry appears in the table of contents. In fact, the foreword to a standard is set by ISO central secretariat so it should not usually be necessary to include one in your documents.

Introduction The introduction to a part of a standard is special in that, if it appears, it is section 0; however, if it does not appear, there is no section 0. Thus, there is a special macro, \introduction, used to introduce the introductory section.

References The references section contains titles of normative documents to which reference is made in the body of the standard. The references section is constructed as follows:

\begin{references}
\bibitem[ISO 8879]{sgml} Information processing ---
    Text and office systems --- Standard
    Generalised Markup Language (SGML).
\end{references}
The output from this is shown in section [*].

The second argument of the \bibitem command is a label which is used in citing the document. For instance, \cite{sgml} gives the output [#!sgml!#].

Definitions A definition is numbered in the same way as a clause but has a run-in header and does not appear in the table of contents; see section [*] for examples. A definition is entered as follows:

\definition{term} Text of definition...


\begin{note}
Definitions and clauses should not appear in the same section
since they are numbered independently of each other.
\end{note}

Annexes The main body of a standard may be followed by annexes. The first annex should be preceded by the \annex command. Each annex then behaves like a section: it is introduced by a \section command and may be divided into clauses etc; the only difference is that annexes are numbered using upper-case letters rather than Roman numerals.